arrayEncode

Type

function

Summary

Serializes a LiveCode array.

Syntax

arrayEncode(<array>,[<encodeVersion>])

Description

Use the arrayEncode function to convert an array into a string so that it can be saved to a file or sent across a network.

The string returned by the arrayEncode function is designed to be used to transfer arrays to remote machines or to save them to a file on disk. It is an opaque, binary encoding of the data contained in the array. The original array can be rebuilt by using the arrayDecode function. Encoded arrays cannot easily be modified, and should always be converted back into real arrays before attemping to access or modify them.

To send an encoded array to a remote process over TCP/IP, it should be encoded using the URLEncode function, as it may contain characters not suitable for use in URLs.

note

Arrays in LiveCode are un-ordered. This means in particular that encoding two arrays will not necessarily produce the same result, even if the arrays had the same elements. To compare two arrays, simply use the = operator directly on them rather than encoding them first.

Parameters

Name	Type	Description
array	array	The array is a LiveCode array.
encodeVersion		If present, and >= "7.0" then the array is encoded in such a way as to preserve unicode in keys and values, as well as NUL chars in keys and values

Examples

savePreferencesData "displayOptions", arrayEncode(sDisplayOptionsArray)

write urlEncode(arrayEncode(tArray)) to socket tSocket

Related

command: write to socket

function: keys, arrayDecode

keyword: left-square-bracketright-square-bracket

Compatibility and Support

Introduced

LiveCode 3.5

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile